home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / gfx / 3d / SceneManager18.lha / Scene_Manager.DOC < prev    next >
Encoding:
Text File  |  1995-03-05  |  9.0 KB  |  194 lines
  1. *****************************************************************
  2. * Scene Manager                                                 *
  3. * Copyright (c) 1994, 1995 by Peter Rittwage and Chris Hurley   *
  4. * All Rights Reserved.                                          *
  5. *****************************************************************
  6.  
  7. -------------------------------------------------------------------------
  8. DISTRIBUTION
  9. -------------------------------------------------------------------------
  10. This program is provided as SHAREWARE. 
  11.  
  12. This implies that if a user finds the program useful, he/she is
  13. obligated to pay a one-time fee to the authors of the program.
  14. If the user finds the program useless (not likely, I hope), he
  15. is obligated to delete it and all related files within a 
  16. reasonable amount of time.
  17.  
  18. Note: Portions of this program have been disabled or not included
  19.        in the distribution to protect the interests of the authors,
  20.        and to promote registration.
  21.  
  22. This program is not to be included with any commercial or
  23. non-commercial package or collection without the written
  24. permission of the authors.
  25.  
  26. The shareware fee for Scene Manager is 20 US Dollars. ($20)
  27. This one-time fee gets the user the latest registered version
  28. with many extra features, (listed in DESCRIPTION section) plus
  29. the piece of mind of supporting a couple of your fellow Lightwave
  30. fans and starving programmers.  
  31.  
  32. US MAILING ADDRESS:
  33.  
  34.    InterVISUAL Software
  35.    1080 Horseshoe Rd.
  36.    Augusta, GA  30904   
  37.    (706) 793-4007 
  38.  
  39.  
  40. -------------------------------------------------------------------------
  41. DISCLAIMER
  42. -------------------------------------------------------------------------
  43. In no way are the authors, or any company formed therein in any way
  44. reponsible for any data or monetary loss brought on by the use or
  45. misuse of this program.  It has been developed and tested for ~10 months
  46. as part of the commercial package "Plantation" written by the same
  47. authors.  We felt that this program had uses beyond the scope of that
  48. product alone, and decided the Lightwave community might benefit
  49. from it's capabilities.
  50.  
  51.  
  52. -------------------------------------------------------------------------
  53. DESCRIPTION
  54. -------------------------------------------------------------------------
  55. Scene Manager is a multi-purpose utility for manipulating scenes created
  56. by Lightwave 3D.  It can move and update scenes around a network, or 
  57. offline, as well as create archives containing all components needed to
  58. render it.  These archives can be undone on your PC, SGI, Raptor3, Mac,
  59. or whatever Lightwave is ultimately released for with or without
  60. the use of a native version of Scene Manager.
  61.  
  62.  
  63. -------------------------------------------------------------------------
  64. LIMITATIONS OF UNREGISTERED VERSION
  65. -------------------------------------------------------------------------
  66. 1) The unregistered version only supports archiving in the LhA format.
  67.    It does NOT support de-archiving (restoring).
  68.  
  69.    LhA is not included in the archive, but is available from Aminet,
  70.     Fred Fish, or your local BBS or user group.  I highly suggest also
  71.     registering LhA, as it is by far the best archiver available for the
  72.     Amiga thus far. (Although I hear that LHX is nice.)
  73.  
  74.    The registered version features a customizable compression scheme. All 
  75.    that is required is the command line option definition for whatever
  76.    archiver you wish to use (and the binary for said archiver).
  77.    It also supports splitting the archives into disk-sized parts, for
  78.    transfer by that method.  DD & HD floppies, SyQuest, and Bernoulli
  79.    disks are all supported in any format you have the drivers for.
  80.    I.E. CrossMAC, CrossDOS...
  81.  
  82.    Current tested archivers include (more can be added instantly):
  83.    .LHA (because it's the Amiga standard)
  84.    .ZIP (for transfer to PC's)
  85.    .LHX (because it's supposedly faster and more efficient)
  86.    .ZOO, .ARC (for old times' sake)
  87.  
  88. 2) The unregistered version will not allow you to process more than one
  89.    scene at a time.  Naturally, the registered version has no such
  90.    limitations.
  91.  
  92.  
  93. -------------------------------------------------------------------------
  94. FUTURE
  95. -------------------------------------------------------------------------
  96. I am open for suggestions!  A Windows version is definately planned, but
  97. it's distribution all depends on the number of registrations we receive.
  98.  
  99.  
  100. -------------------------------------------------------------------------
  101. INSTALLATION
  102. -------------------------------------------------------------------------
  103. Just drag the Scene_Manager icon wherever you wish.
  104. It only requires that you have OS2.0+ installed.
  105.  
  106.  
  107. -------------------------------------------------------------------------
  108. USAGE
  109. -------------------------------------------------------------------------
  110. Upon first running Scene Manager, the program will ask you to locate
  111. the default "3D" drawer of your host machine.  The 3D drawer is part
  112. of Lightwave and contains, among others, the "Scenes", "Objects", and
  113. "Images" drawers.  It is usually located in a directory called "Toaster"
  114. on your hard disk.  Enter the "3D" drawer itself, but do not enter any
  115. drawers therein, Scene Manager will take care of this. The program will
  116. then ask you where you wish to store scene archives.  This can be any
  117. valid AmigaDOS path.  The program will save these locations for further
  118. reference, though you may change it with the "Paths" menu option in the
  119. "Preferences" menu.
  120.  
  121. The "Scenes" listview featured at the top left side of the GUI displays
  122. the scenes you have currently selected to process.  The scenes section of
  123. the interface features two buttons under the listview.
  124.  
  125. ADD         Add a scene or scenes to be moved to the list.
  126.             Multiple scenes can be selected with a "Shift-Click".
  127.  
  128. REMOVE      Remove the currently selected scene from the list.
  129.  
  130.  
  131. The "Destinations" listview featured at the top right side of the
  132. interface displays a list of drawers you wish to move the the scenes 
  133. into.  This is where you specify  which clients will receive the
  134. scenes you are moving.  The destinations section of the interface
  135. also features two buttons under it's listview.
  136.  
  137. ADD         Add a destination to the list.  This allows you to
  138.             build the list of clients you wish to recieve scenes.
  139.             Locate each client's "3D" drawer using the file 
  140.             requester that appears.  As when selecting the default
  141.             "3D" drawer the first time Scene Manager is run, locate
  142.             the "3D" drawer on each client.
  143.  
  144. REMOVE      Removes a client from the list.
  145.  
  146. Scene Manager conveys its current status in the status list, located
  147. on the bottom left of the interface, with the most recent messages at
  148. the top of the list.  The progress of scene manager is displayed here.
  149.  
  150. The three "cycle" options located on the bottom right of the interface
  151. control the various decisions Scene Manager will make upon finding pre-
  152. existing files already located on the destination machine.  By manipulating
  153. the cycle gadgets, you can instruct Scene Manager to either replace the
  154. existing components, or skip them and leave the existing ones alone.
  155.  
  156. Lastly, the two buttons in the bottom right of the interface allow you 
  157. to begin the Scene Manager operation.  The "Program Mode" cycle allows
  158. you to change the programs operation, while the "Execute" button launches
  159. the selected task.
  160.  
  161. COPY        Moves all the scenes you specified, including all their objects
  162.             and images (while abiding by the options you selected in the
  163.             cycle gadgets above it)
  164.  
  165. UPDATE      Only moves the components that have been modified since the
  166.             last movement of the scene.  This is useful when a large scene
  167.             has had small revisions and needn't be totally redistributed.
  168.             This option relies on the proper operation of the battery-backed
  169.             clock/calendar of your Amiga's, so make sure they're operational and
  170.             set correctly.  Details on this procedure can be found in your
  171.             Amiga's user manual.
  172.  
  173. ARCHIVE     This option creates an archive named after the scene or scenes
  174.             specified and puts all the objects and images required by the
  175.             scene into it.
  176.  
  177. RESTORE        This option extracts all the components from the selected archive
  178.             and copies them into the places specified in the destinations
  179.             listview.
  180.                 /* Disabled for unregistered version */
  181.             
  182. DELETE      This option will delete a scene and all related components from
  183.             your drive.  BE CAREFUL, as many files are often used by other
  184.             scenes, (such as FractalReflections, etc.) and they will all
  185.             be wiped out as well.  You have been warned.
  186.  
  187. Scene Manager is provided as a standard mechanism to move scenes whose
  188. components are located in standard locations.  Scenes that have components
  189. located outside the standard "3D" directory heirarchy may need to be pre-
  190. loaded into Lightwave on the clients and the objects resaved, so they may
  191. all be accessable when the time comes to render.  Scenes whose components
  192. were located in the standard heirarchy to begin with need no be resaved on
  193. the new machine.
  194.